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Return 
Value: 


Routine Name: 


Arguments: 


Description: 


char* 


vcuAllocateBuffer(.) 


int channel 


Allocates a buffer with proper caching 
properties, sized for the specified channel 


unsigned int 


vcuClearErrno(.) 


none 


Returns the first recorded VCU error # and 
clears it from the error system 


void 


vcuCommlnit(.) 


none 


Starts the VCU service 


void 


vcuCommHalt(.) 


none 


Forcefully halts all VCU-related tasks 


int 


vcuDataSize(.) 


int channel 


Returns the maximum message size, in 
bytes, for the specified channel 


unsigned int 


vcuErrno(.) 


none 


Returns the first recorded VCU error # 


int 


vcuFree(.) 


int channel, const char *data 


Marks the specified memory location in the 
socket Rx memory pool as usable (see 
detailed description) 


void 


vcuFreeBuffer(.) 


int channel, char *buffer 


Frees a buffer allocated with the 
vcuAllocateBuffer(.) routine 


int 


vcuHasPushQueueMessage(.) 


int channel 


Returns the number of messages in the 
push queue for the specified channel 


int 


vcuHasRxQueueMessage(.) 


int channel 


Returns the number of messages queued 
for the specified channel 


int 


vcuifaceHasRxDataQueueMessage(.) 


none 


Returns the number of vcuRecv(.) replies 
queued 


int 


vculfaceHasRxRqstQueueMessage(.) 


none 


Returns the number of vcuRecv(.) calls 
queued 


int 


vculfaceHasTxQueueMessageQ 


none 


Returns the number of vcuSend(.) calls 
queued 


int 


vcutfaceHasTxReplyQueueMessage(-) 


none 


Returns the number of vcuSend(.) replies 
queued (used for push configs) 


int 


vculfaceHasTxStatusQueueMessage(.) 


none 


Returns the number of vcuSend(.) status 
messages queued 


int 


vculsMemPairPoolEmpty(.) 


none 


Returns 0 if the mem pair pool (used for 
push configs) is not empty and a non-zero 
value if it is empty 


int 


vculsRxPoolEmpty(.) 


int channel 


Returns 0 if the receive pool for the 
specified channel is not empty and a non- 
zero value if it is empty 



Figure 3(a) 
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Return 
Value: 


Routine Name: 


Arguments: 


Description: 


int 


vculsTxPoolEmpty 


int channel 


Returns 0 if the transmit pool for the 
specified channel is not empty and a non- 
zero value if it is empty 


int 


vcuPing(.) 


int destination 


Checks that a remote board is reachable 
via VCU. If more than one bit is set, a table 
is printed 


void 


vcuPrintChannellnfo(-) 


int channel 


Prints out the configuration information for 
the specified channel. If the argument is 0 
(default), a table is printed 


void 


vcuPrintDebug(.) 


int debugLevel 


Triggers a printout of debugging data 


int 


vcuQueryForConfig(.) 


int channel 


Returns the configuration of the channel for 
internal VCU use (defined in vcuDefines.h) 


unsigned int 


vcuRecentErrno(.) 


none 


Returns the last recorded VCU error 
number 


int 


vcuRecv(.) 


See Detailed Description 


See Detailed Description 


int 


vcuRequestErrno(.) 


int destination 


Receives the VCU error # from a remote 
board. If more than one bit is set, a table is 
printed 


int 


vcuReq uestTestPattern( . ) 


int destination, int channel, 
int msgSize 


Requests a remote board to send a pre- 
defined test pattern of a requested size, 
and prints out success or error of delivery 


int 


vcuSend(.) 


See Detailed Description 


See Detailed Description 



Figure 3(b) 



Debug Level: 


Description: 


1 


Prints out the use status of all Rx memory pools 


2 


Prints out the use status of all Tx memory pools 


I 3 


Prints out the use status of all Rx and Tx memory pools 


4 


Prints out detailed information about each slot of all Rx memory pools 


5 


Prints out detailed information about each slot of all Tx memory pools 


6 


Prints out detailed information about each slot of all Rx and Tx memory pools 


7 


Prints out the status of all Rx queues 


8 


Prints out the status of all push queues 


9 


Prints out detailed information about each slot of memPair memory pool 


101 


Prints out internal timing information if the system has been instrumented for timing 



Figure 4 
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Configuration Type: 


Sender Side: 


Receiver Side: 


Copy on Send 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

\ 
/ 


wh»le(RUNNING){ 
vcuRecv(chan, pAddr, size); 

//MonHIo moceana at nAHHr 
//ndilUlc? lllcoodyc dl JJMUUi 

//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Copy to Pool on Receive 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

) 


while(RUNNING){ 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Copy to Buffer on Receive 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

} 


buf = vcuAllocateBuffer(chan) 
while(RUNNING){ 

vcuRecv(chan, buf, size); 

vcuFree(chan, buf); 

} 

vcuFreeBuffer(chan, buf); 
} 


Push to Pool on Receive 


int pAddr = 0x0 
int id = UNIQUE VALUE 
while(RUNNINGH 
vcuSend(dest, chan, data, size, pAddr, 
id); 

} 


while(RUNNING){ 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Push to Buffer on Receive 


int pAddr = 0x0 
int id = UNIQUE VALUE 
while(RUNNING){ 
vcuSend(dest, chan, data, size, pAddr, 
id); 

//Changes in pAddr indicated when data 
//was read 

} 


buf = vcuAllocateBuffer(chan) 
while(RUNNING){ 

vcuRecv(chan, buf, size); 

vcuFree(chan, buf); 

} 

vcuFreeBuffer(chan, buf); 


Queue on Send 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

} 


buf = vuuAllocateBuffer(chan) 
while(RUNN!NG){ 

vcuRecv(chan, buf, size); 

vcuFree(chan, buf); 

x 

vcuFreeBuffer(chan, buf); 


Copy to Self 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

\ 
i 


while(RUNNING){ 
vcuRecv(chan, pAddr, size); 
//Handle messaae at DAddr 
//(size in bytes length) 
vcuFree(chan, pAddr); 

} 


Overwrite on Send 


while(RUNNING){ 
vcuSend(dest, chan, data, size); 

} 


while(RUNNING){ 
vcuRecv(chan, pAddr, size); 
//Handle message at pAddr 
//(size in bytes length) 

} 



Figure 5 
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Application 
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Call vcuSocket.Send() 
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• Flush cache of memory location in 
pool. 
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on timeout. 

• Return status. 
Enqueue status. 
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Mailbox handler (Mailbox 1) 



Enqueue received value. 

Write received value (with first byte 

indicating status) to mailbox 2 on sender 

board. 



msgQ 



VCU Socket Task 



Read a value from msgQ(wait forever). 

The value is interpreted as a memory 

location on the VME bus. 

Read the channel, priority, and data size 

from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the Rx memory 
pool. 

Convert the received memory location to 
indicate the local board as sender, add 
0x20000000, and write this to the 
mailbox location on the sending board. 
Read from msgQ. Record an error on 
timeout. 

Enqueue the Rx memory pool memory 
location in the vcuSocket queue. 



lo\B 



msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



Nf 

Figure 6(a): The sending sequence for the "Copy on Send" 
configuration. 
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Application (108) 



vcuSendO 

Call vcuSocket.SendO 

**Copy header and data to Tx 

memory pool. 

**Flush cache of memory 

location in pool 

**Write memory location in 

pool (seen from VME bus) to 

mailbox 1 on destination 

board. 

**Read from msgQ. Return a 
fail value on timeout. 
"Return status 
Return status 
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**Write received value (with first 
byte masked out) to mailbox 2TJTT 
receiving board, 
**Enqueue received value 
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VCU Socket Task 



**Read a value from msgQ (wait 
forever) 

**Convert value to local memory 
value and release the memory 
location from the Tx memory pool 



VME Bus 
(110) 
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1016 



Mailbox Handler (Mailbox 1) 



**Enqueue received value. 

**Write received value (with first 
_byte indicating status) to mailbox 2 
"on the sending board. 



1008 



msgQ 



VCU Socket Task 



**Read a value from msgQ (wait 

forever). The value is interpreted as 

a memory location on the VME bus. 
_**Read the channel, priority, and 

data size from the header at the 

received memory location. 

**Copy the data, including the data 
-size portion of the header, to the Rx 

memory pool. 

_**Convert the received memory 
"location to indicate the local board 

as the sender, add 0x20000000, 

and write this to the mailbox location 

on the sending board. 

**Read from msgQ. Record an error 

on timeout. 

**Enqueue the Rx memory pool 
memory location in the vcuSocket 
queue. 
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Figure 6(b) 

(sending sequence for copy on send configuration with VCU Tx Task removed) 
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Application 



L 



108 



vcuRecvO 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to input 
arguments. 

• Return status. 
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Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• Receive from the vcuSocket queue, based on the 
channel. 

• Put the data, data size, channel configuration, and 
receive status into a reply structure. 

Enqueue receive reply structure. 



Figure 7(a): The receiving sequence for the "Copy on Send" configuration. 
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Application (108) 



vcuRecvO 

**Ca!l vcuSocket.Recv() 

"Receive from the vcuSocket queue, 

based on the channel 

**Write the value received into the 

appropriate argument. 

**Return status. 

**Set the message size to the value in the 
header of the message stored at the 
location indicated in the return value. 
**Set the message location in the input 
argument 



Figure 7(b) 

(receiving sequence for the copy on send configuration with the VCU Rx Task removed) 
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vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 



I V msgQ 



msgQ f> 
VCUTxTask 1<>M* I— J 



Read request from msgQ (wait forever). 
Call vcuSocket.UpdateO 

• Copy header and data to Tx memory 
pool. 

• Flush cache of memory location in 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on 
destination board. ™ 

• Read from msgQ. Return a fail value 
on timeout. 

• Return status 
Enqueue status. 
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Mailbox handler (Mailbox 2) 



Enqueue received value. 
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( 
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L 
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Mailbox handler (Mailbox 1) 



Write received value (with first byte 
indicating status) to mailbox 2 on sender 
board. 

Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ(wait forever). 
The value is interpreted as a memory 
location on the VME bus. 
Read the channel and priority from the 
header at the received memory location. 
Enqueue the memory location in the 
vcuSocket queue. 



SQvDlK) G> Fi g ure 8 ( a ) : The sending sequence for the "Copy to Pool on Recv" configuration. RfcjElVltJd, 
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Application (108) 



vcuSendO 

Call vcuSocket.SendO 

**Copy header and data to 
Tx memory pool. 
**Flush cache of memory 
location in pool 
**Write memory location in - 
pool (seen from VME bus) 
to mailbox 1 on destination 
board. 

**Read from msgQ. Return 
a fail value on timeout. 
**Return status 
Return status 
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v 
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Mailbox Handler (Mailbox 2) 



Enqueue received value 



Tx Memory Pool 




v — 

Sending Board 



VME Bus 
(110) 
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_L 
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Mailbox Handler (Mailbox 1) 



**Write received value (with first 
byte indicating status) to mailbox 2 
"on the sending board. 
**Enqueue received value 



1050 | — | 



VCU Socket Task 



**Read a value from msgQ (wait 
forever). The value is interpreted as 
a memory location on the VME bus. 
_**Read the channel and priority from 
the header at the received memory 
location. 

**Enqueue the memory location in 
the vcuSocket queue. 



v 

Receiving Board 



Figure 8(b) 

(sending sequence for copy to pool on receive configuration) 
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Application 



r 



/o<3 



vcuRecvQ 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to 
input arguments. 

• Return status. 
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msgQ 



msgQ Kjj Y 
VCU Rx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.RecvO 

• Receive a VME bus address from the 
vcuSocket queue, based on the 
channel. 

• Read the data size from the header. - 

• Copy the data at the VME bus 
address to the Rx memory pool. 

• Convert the received memory 
location to indicate the local board as^ 
sender, add 0x20000000, and write 
this to the mailbox location on the 
sending board. 

• Read from msgQ. Return an error on 
timeout. 

Put the data location, data size, channel 
configuration, and receive status into a 
reply structure. 
Enqueue the reply structure. 
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Mailbox handler (Mailbox 2) 




Enqueue received value 
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Tx memory pool 



X 



Mailbox handler (Mailbox 1) 



• Write received value (with first byte 
™ masked out) to mailbox 2 on sender 

board. 

• Enqueue received value. 



msgQ 



V 



VCU Socket Task 



• Read a value from msgQ(wait forever). 

• Covert value to local memory value and 
release the memory location from the Tx 
memory pool. 



J 



GZ<&l*&£ffB& Figure 9(a): The receiving sequence for the "Copy to Pool on Recv" configuration.! 



Title: Method And Apparatus For Communicating Data Over 

A Bus According To Redefinable Configurations 
Inventor(s) : Winkeler et al. 

Express Mail. No. EV3286 1 8 1 05US 
Docket # 66638/40337 

13/54 



Application (108) 



vcuRecvO 

Call vcuSocket.RecvO 

**Receive a VME bus address 
from the vcuSocket queue, 
based on the channel. 

**Read the data size from 

the header. 

"Copy the data at the VME 
bus address to the Rx 
memory pool. 
"Convert the received 
memory location to indicate 
the local board as the 

sender, add 0x20000000, 

and write this to the 
mailbox location on the 
sending board. 
"Read from msgQ. 
Record an error on timeout. 
**Write data location, data 
size, channel configuration, 
and receive status into a 
reply structure. 
Return reply structure. 

**Write data location and data size 

to input arguments. 

**Retum status. 
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msgQ 



Mailbox Handler (Mailbox 2) 



Enqueue received value 



1004 

_L 



VME Bus 
(110) 
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106 



Tx memory pool 



Receiving Board 



Figure 9(b) 



Mailbox Handler (Mailbox 1) 



**Write received value (with first 
byte indicating status) to mailbox 2 
"on the sending board. 
**Enqueue received value 




msgQ 1068 
VCU Socket Task 



**Read a value from msgQ (wait 
forever). 

**Convert value to local memory 
value and release the memory 
location from the Tx memory pool 



v. 



v 

Sending Board 



(receiving sequence for copy to pool on receive configuration) 
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Application 



r 



10W 



vcuSendO 

• Enqueue request 

• Read response from msgQ (wait 
forever) 

• Update the memory location value in 
the input argument. 

• Return status. 



msgQ msgQ 
VCU Tx Task 



0 



Read request from msgQ (wait forever). 
Call vcuSocket.UpdateO 

• Try to lock specified location in Tx 
memory pool. If fails, take a new 
memory location and lock it. 

• Copy data to Tx memory pool. 

• Flush cache of memory location in 
pool. 

• Unlock location in Tx memory pool. 

• If using a new memory location imK ^ 
(initial lock failed), write memory 
location in pool (seen from VME bus) 
to mailbox 1 on destination board. 
Read from msgQ. Return a fail value 
on timeout. 

Put the memory location and transmission 
status into a reply structure. 
Enqueue the reply structure. 



[j i 



msgQ 

Mailbox handler (Mailbox 2) 
Enqueue received value. 



Tx memory pool 



VME bus 



J 



i 



\io 



— ► 



Mailbox handler (Mailbox 1) 



• Write received value (with first byte 
indicating status) to mailbox 2 on sender 

"" board. 

• Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ(wait forever). 
The value is interpreted as a memory 
location on the VME bus. 
Read the channel and priority from the 
header at the received memory location. 
Enqueue the memory location in the 
vcuSocket queue. 



Figure 10: The sending sequence for the "Push to Pool on Recv" configuration 
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Application 



10& 



\0U 

v 



vcuRecvO 

• Enqueue request 

• Read reply from msgQ (wait 
forever). 

• Write data location and data size to 
input arguments. 

• Return status 



msgQ 



msgQ 



A 



V 



VCU Rx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• Receive a VME bus address from the 
vcuSocket queue, based on the 
channel. 

• Take a memory location in the Rx 
memory pool. 

• Write the VME bus address, the 
local address (as seen from the VME 
bus), an ID, and the channel to a 
location in the mem pair memory 
pool. 

• Add 0x40000000 to the mem pair 
memory address and write this to the 
mailbox location on the sending 
board. 



• Read from msgQ. Return a fail value 
on timeout. 

• Read response from Push msgQ (wait 
forever). Verify that response 
matches ID. 

• Read the data size from the mem pair 
memory pool, then release the slot in 
the pool. 

Put the data location, data size, channel 
configuration, and receive status into a 
reply structure. 
Enqueue the reply structure. 



A 



msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



r 



MO 



VME bus 



Mailbox handler (Mailbox 1) 



• Write received value (with first byte 
indicating status) to mailbox 2 on 
receiver board. 

• Enqueue received value. 



msgQ 

\/ VCU Socket Task 



Continued on next page 



Read a value from msgQ(wait 
forever). 

Subtract 0x40000000 from the 
received value to get a VME bus 
address. 

Read source and destination memory 
locations, channel, and ID from across 
VME bus. 

Lock the local (source) memory 
location, which is in the Tx memory 
pool. 

Write the data size across the VME 
bus 

Copy data from source to destination. 
Release the local (source) memory 
location. Clear the owner ID, Unlock 
the memory location. 
Logically AND a board-specific 
value, a bit-shifted version of the ID 
read from across the VME bus, and 
the channel. Write the result to the 
mailbox location on the receiving 
board. 

Read from msgQ. Record a fail value 
on timeout. 



A 



msgQ 



►Mailbox handler (Mailbox 2) 



Enqueue received value 



Figure 11(a) je\)*>»06 
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Continued from previous page 
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Rx memory doo! 
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Mailbox handler (Mailbox 1 ) 

• Write received value (with first byte 
indicating status) to mailbox 2 on 
receiver board. ™ 

• Enqueue received value. 



msgQ 

\/ VCU Socket Task 

• Read a value from msgQ (wait 
forever). 

• Convert the received value and 
enqueue the result in the Push msgQ. 



Figure 11(b): The receiving sequence for the "Push to Pool on Recv" configuration. 
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Application 



V 



c 



vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 



V 



msgQ msgQ 

A 

VCU Tx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.SendO 

• Copy header and data to Tx memory 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on 
destination board. 

• Read from queue. Return a fail value 
on timeout 

• Return status. 
Enqueue status. 



ft 



msgQ 

Mailbox handler (Mailbox 2) 



Enqueue received value. 



Tx memory pool 



Mailbox handler (Mailbox 1) 



Write received value (with first byte 
indicating status ) to mailbox 2 on 
receiver board. ^ ■ 



• Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ (wait 
forever). 

Covert value to local memory value 
and release the memory location from 
the Tx memory pool. 



VME bus 



Mailbox handler (Mailbox 1) 



Write received value (with first byte 
indicating status) to mailbox 2 on sender 
board. 

Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ(wait forever). 

The value is interpreted as a memory 

location on the VME bus. 

Read the channel, priority, and data size 

from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the vcuSocket 
queue. 

Convert the received memory location to 
indicate the local board as sender, add 
0x20000000, and write this to the 
mailbox location on the sending board. 
Read from msgQ. Return an error on 
timeout. 



A 



msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



Figure 12: The sending sequence for the "Queue on Send" 
configuration. 



L ^^-^ _ J 
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Application 



r 



10G 



vcuRecvO 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data size to input argument. 

• Return status. 



( 



104 



msgQ 



/\ msgQ 



V 



VCU Rx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• Receive from the vcuSocket queue, based on the 
channel. 

• Copy the data into the location specified in the 
request. 

• Put the data size, channel configuration, and 
receive status into a reply structure. 

Enqueue receive reply structure. 



Figure 13: The receiving sequence for the "Queue on Send" configuration. 
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Application 



L 



I oft 



vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 



msgQ 



msgQ 



A 



V 



VCU Tx Task ' — ' 



Read request from msgQ (wait forever). 
Call vcuSocket.SendToSelf() 

• Copy header and data to Rx memory 
pool. 

• Enqueue the Rx memory pool 
memory location in the vcuSocket 
queue. 

• Return status. 
Enqueue status. 



10L 



Figure 14: The sending sequence for the "Copy to Self' configuration. 



Application 



vcuRecv() 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to input 
arguments. 

• Return status. 



./f 



]b(o 



msgQ 



A 



V 



VCU Rx Task 



msgQ 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• Receive from the vcuSocket queue, based on the 
channel. 

• Put the data, data size, channel configuration, and 
receive status into a reply structure. 

Enqueue receive reply structure. 



Figure 15: The receiving sequence for the "Copy to SelP configuration. 
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Application 



vcuSendO 

• Enqueue request. 

• Read status message from msgQ 
(wait forever). 

• Return status. 



0 



msgQ msgQ 
VCU Tx Task 



Read request from msgQ (wait forever). 
Call vcuSocket.Send() 

• Copy header and data to Tx memory 
pool. 

• Flush cache of memory location in 
pool. 

• Write memory location in pool (seen 
from VME bus) to mailbox 1 on mmm 
destination board. 

• Read from msgQ. Return a fail value 
on timeout. 

• Return status. 
Enqueue status. 



^J^ msgQ 
Mailbox handler (Mailbox 2) ^ m 



Enqueue received value 



Tx memory pool 



Mailbox handler (Mailbox 1) 



Write received value (with first byte 
masked out) to mailbox 2 on receiver 
board. ^ — — — 



Enqueue received value. 



msgQ 



V 



VCU Socket Task 



Read a value from msgQ (wait 
forever). 

Covert value to local memory value 
and release the memory location from 
the Tx memory pool. 



VME bus 



X 



Mailbox handler (Mailbox 1) 



• Enqueue received value. 

• Write received value (with first byte 
~ indicating status) to mailbox 2 on sender 

board. 



^JmsgQ 



VCU Socket Task 



Read a value from msgQ(wait forever). 

The value is interpreted as a memory 

location on the VME bus. 

Read the channel, priority, and data size 

from the header at the received memory 

location. 

Copy the data, including the data size 
portion of the header, to the back buffer 
of the double buffer. 

Convert the received memory location to 
indicate the local board as sender, add 
0x20000000, and write this to the 
mailbox location on the sending board. 
Read from msgQ. Record an error on 
timeout. 



msgQ 



Mailbox handler (Mailbox 2) 



Enqueue received value 



Figure 16: The sending sequence for the "Overwrite on Send" 
configuration. 
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Application 



r 



vcuRecv() 

• Enqueue request 

• Read reply from msgQ (wait forever). 

• Write data location and data size to input 
arguments. 

• Return status. 



c 



lot 



msgQ 



A 



V 



VCU Rx Task 



msgQ 



Read request from msgQ (wait forever). 
Call vcuSocket.Recv() 

• If new data has been written to the back buffer of 
the double buffer, swap the buffers. 

• Read out of the front buffer of the double buffer. 

• Put the data, data size, channel configuration, and 
receive status into a reply structure. 



Figure 17: The receiving sequence for the "Overwrite on Send" configuration. 
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Application 



108 



vcuFreeO 

• Enqueue request 

• Return status. 



1 



msgQ 



V 



Read request from msgQ (wait forever). 
Call vcuSocket.Free() 

• Release memory from the Rx memory pool, based 
on the channel. 



Figure 18: The freeing sequence for the receiver-side memory pool. 
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User Input 



Configuration File 



User Interface 
and 

AutoConfig Parser 



vcuConfig.cpp 
File 



vcuConfig.h 
File 



vculnterface.h 
File 



Figure 19(a) 



User Input 



Configuration File 



Command Line 
and 

AutoConfig Parser 



vcuConfig.cpp 
File 



vcuConfig.h 
File 



vculnterface.h 
File 



Figure 19(b) 
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VCU Configuration File Grammar: Backus-Naur Form (BNF) 



Top Level: 

<contlg_file>::=,channel_section> [<include_section>] [<handler_section>] [misc_section>] 



Description: The configuration file should contain a channel declaration section and may optionally contain entries for 

include files, handler files, and other miscellaneous parameters. 



Channel Declaration Section: 



<channel_section>::=Channels number <channel_statements> 

Description: The channel declaration should begin with the keyword "Channels" followed by a number representing the 

number of channels in the system. This is then followed by said number of channel declaration statements. 



Channel Declaration Statements: 



<channel_statements>::=<channel_statement> | <channeLstatement> <channel_statements> 



<channel_statement>::=Chan number <channeLdata_type> channel^name <channel_type> 



<channel_data_type>::=[struct | class] custom Jype | untyped byte_count 



<channeljype>::=recvbuf | send | pushbuf |recvpool | pushpool |queue | self| overwrite | qself 



Description: A channel statement provides the channel number followed by the channel data type which may be a 

structure or class of user-defined custom Jype, or an untyped string of byte_count bytes. The last two tokens 
in a channel statement should be the user-defined channel_name and the channel__type. There also should 
be as many channel statements as the number of channels declared in the beginning of the channel 
declaration section. 



Include File Section: 



<include_section>::= Include number <include_statements> 



<include_statements>::= include_statement> | <include_statement> <include_statements> 



<include_statement>::= Include include Jile 



Description: The include file section provides a number of filenames that should be "included" by the file vculnterface.h 

generated by the VCU configuration utility. The section must begin with the keyword "Include" followed by a 
number representing the number of include files in the configuration file. This is then followed by said numbe: 
of include statements. Each include statement starts with the keyword "Include" and is followed by the 
filename include Jile which should be "included" by vculnterface.h. 



Handler File Section: 



<handler_section>::=Handlers number <handler_statements> 



<handler_statements>::=<handler_statement> | <handler_statement> <handler_statements> 



<handler_statement>::=Hndlr fcand/rJ7/e 



Description: The handler file section provides a number of filenames that should be "included" by the file vcuConfig.cpp 

generated by the VCU configuration utility. The section must begin with the keyword "Handlers" followed by a 
number representing a number of handler files in the configuration file. This is then followed by said number 
of handler statements. Each handler statement starts with the keyword "Handlr" and is followed by the 
filename handlerjile which should be "included" by the vcuConfig.cpp file. 



Figure 20(a) 
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VCU Configuration File Grammar: Backus-Naur Form (BNF) (co nt.) 
Miscellaneous Parameters Section: 



<misc_section>::=[<pool _parameters] [<single _parameters>] [<multiple_parameters>] 



<single parameters>::=[<ackmailbox_parameter>] [<autoackoff_parameter>] [<autoackon_parameter>] 

[datamailbox_parameter>] [<debugon _parameter>l [<mailboxqueuesize_parameter>] 
[<mempairpoolsize_parameter>] [<partitionaddr_j)arameter>] [<partitionfactor_j>arameter>] 
[<slavewinsize_parameter>] [<taskpriority_parameter>] 



<multiplej3arametere>::=<multiplejDarameter>|<multiplej3arameter> <multiple_parameters> 



<mu!tiple^arameter>::=<dmaj3arameter>|<dmastar^^ 

<rxpoolsize_parameter>|<rxqueuesize_parameter>|<txpoolsize_parameter> 

Description: Single parameter options should occur only once per configuration file, while multiple parameter options may 

occur several times, usually on a per-channel basis. 



Pool Parameters: 



<pool_parameters>::=BoardCount number [<norxpool_parameters>] [<notxpool_j>arameters>] 



<norxpool^arametere>::=<norxpoolj3arameter>|<noixpool_^arameter><norxpool_parameters> 



<notxpooi_parameters>::=<notxpool _parameter>|<notxpool_parameter><notxpool_parameters> 



<norxpool_parameter>::=NoRxPool chan_number board _processor_number 



<notxpooLparameter>::=NoTxPool chanjnumber board _processor__number 

Description: The pool parameters indicate which, if any, channel/board combinations should not allow receiving or 

transmitting respectively. The parameter list begins with the "BoardCount" keyword followed by the number of 
boards, or system processors, in the system. This is followed by one or more "NoRxPool" or "NoTxPool" 
keywords which tell the system which channel/board pairings, indicated by chan_number and 
board_processor_number f should not allow receiving and transmitting respectively. 

AckMaiibox Parameter: 



<ackmailboxj3arameter>::=AckMailbox number 



Description: This option indicates which mailbox, represented by number, should be used for automatic 

acknowledgements. This value must be different from the DataMailbox value, and defaults to 



AutoAckOff Parameter: 



<autoackoff_parameter>: :=AutoAckOff 



Description: This option indicates that auto acknowledgement should not be used in the VCU system. 

AutoAckOn Parameter: 



<autoackon_parameter>::=AutoAckOn f!oating_point_number 



Description: This option turns on the automatic acknowledgement feature of the VCU system. The f!oating_point_n umber 

indicates the timeout value in seconds before the message is assumed lost. This value defaults to 0.05 seconds. 



DataMailbox Parameter: 



<datamailbox _parameter>::=DataMailbox number 



Description: This indicates which mailbox, represented by number, should be used for inter-board communication. This 

value must be different from the AckMaiibox value, and defaults to 1 . 



Figure 20(b) 
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VCU Configuration File Grammar: Backus-Naur F rm (BNF) (cont.) 
Miscellaneous Parameters Section (c nt): 



Debug Parameter: 



<debugon_parameter>::=DebugOn 



Description: This option turns on the printing to console all values received in the data mailbox interrupt. 



Mailbox Queue Size Parameter: 



<mailboxqueuesize_parameter>: :=MailboxQueueSize size 



Description: This option sets the size of the message queue leaving the mailbox ISR. The default size is 8. 



Memory Pair Pool Size Parameter: 



<mempairpoolsize_parameter>::=MemPairPoolSize size 



Description: This option sets the size of the memory pool for memory pairs used by all "push" channels on the board The 

default size is 8. 



Partition Address Parameter: 



<partitionaddr j3arameter>::=PartitionAddress addr 



Description: This option sets the location of the memory partition created by the VCU for VME bus accessibility to the 

value specified in addr. 



Partition Factor Parameter: 



<partitionfactor_parameter>: :=PartitionFactor factor 



Description: This option sets the factor used in setting the size of the partition. 



Slave Window Size Parameter: 



<slavewinsize_parameter>::=SlaveWindowSize half | SlaveWindowSize full 



Description: This option sets the size of the VME slave windows for boards in the system. "Half sets the size to 

0x04000000 and "full" to 0x08000000, with the default being half. 



Task Priority Parameter: 



<taskpriority_parameter>::=TaskPriority priority 



Description: This option sets the priority for the VCU socket task. 



DMA Parameter: 



<dma _parameter>::=DMA chan_number 



Description: This option turns forces the indicated chan_number\o always use DMA. 



DMA Start Parameter: 



<dmastart_parameter>::=DMAStart chan_number message_size 



Description: This option forces the indicated chan_number to always use DMA for messages that have sizes that are 

greater than or equal to message^size bytes. 



Figure 20(c) 
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VCU Configuration File Grammar: Backus-Naur Form (BNF) (con t.) 

Misc llaneous Parameters Section (cont): 

Event Parameter: 



<event_parameter>::=Event chan^number eventjhandler 



Description: This option specifies the routine {event_handler) to be called when a board receives a message for the 

channel indicated by channel_number. 



Guaranteed Delivery Parameter: 



<guaranteeddel_parameter>::=GuaranteedDelivery chan_number 



Description: This option forces the indicated chan^number to block on certain queue and pool overflows rather than risk 

losing the message. 



Receive Pool Size Parameter: 



<rxpoo!size_parameter>::=RxPoolSize chan_number size 



Description: This option sets the size of the receiving memory pool for the indicated chan_number. The default value is 8. 



Receive Queue Size Parameter: 



<rxqueuesize_parameter>::=RxQueueSize chan_number size 



Description: This option sets the size of the receiving message queue for the indicated chan_number. The default value is 



Transmit Pool Size Parameter: 



<txpoolsize_j>arameter>::=TxPoolSize chan_number size 



Description: This option sets the size of the transmitting memory pool for the indicated chan_number. The default value is 



Figure 20(d) 
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Figure 21: Initial Dialog Window for the GUI 
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Figure 22: Primary dialog window of the GUI 
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Figure 23: The "More configuration options" dialog window 
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Figure 24: The "Board configuration" dialog window 
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Figure 25: The "VCU system configuration" dialog window 
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Figure 26: The "Writing the current configuration" dialog window 
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Figure 27: The "Writing the VCU source files" dialog window 
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Configuration: 


Receive Queue Size: 


Receive Pool Size: 


Copy on Send 


Maximum difference between the number of 
remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


Maximum difference between the number 
of remote vcuSend() and local vcuRecv() 
calls. On overflow, the message is lost or 
the entire system blocks 


Copy to Pool on Receive 


Maximum difference between the numhpr nf 

iviasvn i iui l l uiiici luC UCIVVCCI 1 LI IC IIUMIUCI Ul 

remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks. 


iviaximurn aiiTerence Derween tne numoer 
of vcuRecvQ and vcuFree() calls. On 
overflow, vcuRecv() returns an error 


Copy to Buffer on Receive 


Maximum difference hetwpen the numhpr nf 

ivihaii i iui I f UMIwiwIIVi/C UCIWCCI 1 IMC IIUMIUCI Ul 

remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


KJ/A 
IN/A 


Push to Pool on Receive 


Maximum number of remote sources of 
vcuSend() calls (each source has a unique ID 
and keeps track of the transmit pool address it is 
using). On overflow, the message is lost or the 
entire system blocks. 


Maximum difference between the number 
of vcuRecvQ and vcuFree() calls. On 
overflow, vcuRecv() returns an error 


Push to Buffer on Receive 


Maximum number of remote sources of 
vcuSend() calls (each source has a unique ID 
and keeps track of the transmit pool address it is 
using). On overflow, the message is lost or the 
entire system blocks. 


N/A 


Queue on Send 


Maximum difference between the number of 
remote vcuSend() and local vcuRecv() calls. On 
overflow, the message is lost or the entire 
system blocks 


N/A 


Copy to Self 


Maximum difference between the number of 
vcuSendQ and vcuRecv() calls. On overflow, 
vcuSendQ returns an error 


Maximum difference between the number 
of vcuRecv() and vcuFree() calls. On 
overflow, vcuRecvQ returns an error 


Overwrite on Send 


N/A 


N/A 



Figure 28 
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Configuration: 


Transmit Pool Size* 




Copy on Send 


Maximum number of local sources of vcuSend() 

calls On overflow vcuSendn return*; an prrnr 


0 


Copy to Pool on Receive 


Maximum difference between the number of 
local vcuSend() and remote vcuRecv() calls. On 
overflow, vcuSend() returns an error. 


n 
\j 


Copy to Buffer on Receive 


Maximum difference between the number of 
local vcuSend() and remote vcuRecv() calls. On 
overflow, vcuSend() returns an error. 


0 


Push to Pool on Receive 


Twice the number of local sources of vcuSend() 
calls (each source has a unique ID and keeps 
track of the transmit pool address it is using). 
On overflow, vcuSend() returns an error. 


Maximum number of local sources of 
vcuSend() calls. On overflow, vcuSend() 
returns an error 


Push to Buffer on Receive 


Twice the number of local sources of vcuSend() 
calls (each source has a unique ID and keeps 
track of the transmit pool address it is using). 
On overflow, vcuSend() returns an error. 


Maximum number of local sources of 
vcuSendQ calls. On overflow, vcuSend() 
returns an error 


Queue on Send 


Maximum number of local sources of vcuSend() 
calls. On overflow, vcuSend() returns an error. 


0 


Copy to Self 


N/A 


0 


Overwrite on Send 


Maximum number of local sources of vcuSend() 
calls. On overflow, vcuSendQ returns an error. 


0 



Figure 29 
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382 



384 



Channels 6 
Chan 1 buttonPress 
Chan 2 class Eventlnfo 
Chan 3 struct NavData 
Chan 4 untyped 1024 
Chan 5 untyped 32 
Chan 6 untyped 8 
Includes 3 
Incl NavData. h 
Incl Eventlnfo.h 
Incl ButtonPress.h 
MailboxQueueSize 1 0 
DMA 1 
NO_DMA 2 
RxPoolSize 1 10 
TxPoolSize 1 10 



^380 



BUTTON_PRESS_CHANNEL recvbuf 

EVENT_INFO_CHANNEL send 

NAV_DATA_CHANNEL pushbuf 

BIG_RAW_DATA_CHANNEL recvpool 

S MA L L_RAW_D AT A_C H A N N E L pushpool 

SMALL_FAST_CHANNEL queue 



Figure 30: An example configuration file 
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Keyword: 


Parameters: 


Meaning: 


AckMailbox 


1 


"AckMailbox" indicates the mailbox used for the automatic acknowledgement. It should 
differ from the "DataMailbox" value. The default value is 2. 


AutoAckOff 


0 


"AutoAckOff turns off the automatic acknowledgement system for the VCU. With auto 
ack turned off, the VCU uses only one mailbox interrupt per board, but cannot 
guarantee that messages will not be lost. 


AutoAckOn 


1 


"AutoAckOn" turns on the automatic acknowledgement system for the VCU. The 
parameter sets the deiav for an acknowledgement frnm thp repeiv/inn hnarH hafnro tho 
message is assumed lost. The default value for the parameter is 0.05 (in seconds). 


BoardCount 


1 


"BoardCount" specifies the number of boards in the ^v<;tpm Thic vainp ic rtniv mcoH in 
conjunction with "NoRxPool" and "NoTxPool". 


Chan 


4 (or 5) 


"Chan" SDecifies a data tvoe channel name and rnnfinuratinn tvnp for nno rhannol 

wiiwii -~rfs\* vii u unia Lj^j^t icii ii iv»i i iul I ic, cm IVJ \*\Jl 1 HUUI GUUI 1 LyUC IUI Ui IvJ Ul Id 1 1 1 It? 1 . 

Specifying "Chan" a second time for a channel resets the DMA size specs, even if they 
were chanaed from default bv a "DmaStart" line "nhan rr iq nnt aiinwoH Aier* Thon" 

" v,v viiaiiy»*M "wmi uciouil \jy a i*/ 1 1 iao Id 1 1 line. ulldll VJ lo I1UI dilUWGU. r\ISO, 1/1)311 

cannot be specified before "Channels". 


Channels 


1 


"Channels" specifies the number of channels in the VCU. It should not appear more 
than once in the configuration file. 


DataMailbox 


1 


"DataMailbox" indicates the mailbox used by the VCU for inter-board communication. 
It must differ from the "AckMailbox" value. The default value is 1 . 


DebugOn 


0 


Turns on printing of all values received in the data mailbox interrupt 


DMA 


1 


"DMA" specifies that the indicated channel should always use DMA. 


DmaStart 


2 


"DmaStart" specifies that the indicated channel should use DMA for any message 
larger than that specified by the second parameter (the size being in bytes). 


Event 


2 


"Event" SDecifies a routine that Should be nailed a<; «;non a^ a hnard rprpiuac Hata r\n 

the indicated channel. The first parameter is the channel, and the second parameter is 
the routine (the routine preferably cannot take any input argument and cannot return 
any value). 


Guaranteed Delivery 


1 


"GuaranteedDelivery" indicates that the channel will block on certain queue and pool 
overflows, rather than lose the message. The queue and pool overflows in question 
are those that are unreoortable a^ returns tn um^pnriA umRorvA nr wrnfraoA ^^iio 
Blocking on these overflows blocks all incoming messages for the board in question 
and can result in other queues and pools overflowing. 


Handlers 


1 


"Handlers" specifies the number of files to be included in the vcuConfig.cpp file. It 
should not be called twice. 


Hndlr 




"Hndlr" specifies a file to be included in the vcuConfig.cpp file. If too many or too few 
files are specified, the autoConfig code declares the configuration invalid. "Hndlr" 
should not be specified before "Handlers". 


Includes 




"Includes" specifies the number of files to be included in the file vculnterface.h. 
"Includes" should not be called more than once. 


Incl 




"Incl" specifies a file to be included in the file vculnterface.h. If too many or too few I 
files are specified, the autoConfig code declares the configuration invalid. "Incl" should 
not be specified before "Includes". 


MailboxQueueSize 




"MailboxQueueSize" specifies the size of the msgQ leaving the mailbox ISR. The 
default value is 8. 


MemPairPoolSize 




"MemPairPoolSize" specifies the size of the memory pool for memory pairs (used in 
the "push..." configuration types). This is a board-wide memory pool, used by all 
channels. The default value is 8. 
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Keyword: 


Parameters: 


Meaning: 


No_DMA 


1 


"No_DMA" specifies that the indicated channel should never use DMA. 


NoRxPool 


2 


"NoRxPool" specifies a channel and board where the VCU should not support receive 
operations. The first parameter is the channel and the second parameter is the board's 
system processor number. If NoRxPool is specified for any board in a channel, then 
the svstem orocessor numbers should hp in thp rannp nf n tn RnarHPmmt.1 

u ic & J <j k\* 1 1 1 yjl VvvwtfV/l IIUIIIWCI9 9IIUUIU Ug III Ills? lallUv \Jl \J l\J DUalUvUUI 11 1 . 


NoTxPool 


2 


"NoTxPool" specifies a channel and board where the VCU should not support transmit 
operations. The first parameter is the channel and the second parameter is the board's 
svstem Drocessor number If NoTxPool is snprifipd for anv hnard in a channel thon 
the system processor numbers should be in the range of 0 to BoardCount-1 . 


PartitionAddress 


1 


"PartitionAddress" specifies the location of the memory partition created by the VCU for 
VME bus accessibility. 


PartitionFactor 


1 


"PartitionFactor" specifies the factor used in setting the size of the partition. Buffers 

USfid to receive data in the "niish to hnffpr nn rpr.piwp" rvmfimi rati r»n hvno aro olln^otorl 

from here, so these drive the size of the partition factor. The factor also allows for 
fragmented allocation because of the memory alignment specified in the allocation. 


RxPoolSize 


2 


"RxPoolSize" specifies the size of the receiving memory pool for a channel. The first 
parameter is the channel, and the second parameter is the pool size. The default 
value is 8. 


RxQueueSize 


2 


"RxQueueSize" soecifies the size of the reeeivina ntjpup fnr a rhannel Thp firct 

■ v^ifcw vpvviUWt? LI Iw Ol&v wl 11 Iw 1 wvvl Vfl IU UUwUw 1 v 1 Cm wl 1 0 1 1 1 ICf » 1 llv? lllol 

parameter is the channel, and the second parameter is the queue size. The default 
value is 8. 


RxReplyQueueSize 


1 


"RxReDlvQueueSize" SDecifies the size of the aueue rieliverinn rpsnnnsps frnm thp 
VCU Rx Task to the vcuRecv() routine. 


RxRqstQueueSize 


1 


"RxRastQueueSize" soecifies the size of the ouplip dplh/prinn vruRprvA rpnnp^tQ tn 
the VCU Rx Task. 


RxTaskCount 


1 


"RxTaskCount" specifies the number of tasks set aside to handle vcuRecv() calls. The 
first task handles all non-blockina calls while the other tasks handle blockino calk 

,M Vfc ifcflw^ 1 * iiuiiuivv wii iivii uivvimi ivj w 1 1 w | ft I 1 1 1 w LI lv vll Iwl LaOrxO IIQI lUlw UlvwiNII IU wCillO. 

The minimum value should be 2 unless vcuRecv() will never be called as blocking. 
The default value is 4. 


SlaveWindowSize 


1 


"SlaveWindowSize" specifies the size of the slave windows for boards in the system. 
The valid options are "half and "full", which correspond to 0x04000000 and 
0x08000000. The default value is "half. 


TaskPriority 


2 


"TaskPriority" specifies the priority of the indicated task, "Socket", Tx", "Rx", or 
"Debug". The default value is 100 for ail tasks. 


TxPoolSize 


2 


"TxPoolSize" specifies the size of the transmitting memory pool for a channel. The first 
parameter is the channel, and the second parameter is the poo! size. The default 
value is 8. 


TxReplyQueueSize 


1 


"TxReplyQueueSize" specifies the size of the queue that delivers update responses 
from the VCU Tx Task to the vcuSend() routine. 


TxRqstQueueSize 


1 


"TxRqstQueueSize" specifies the size of the queue that delivers vcuSend() requests to 
the task that actually performs the data transmission (the VCU Tx Task). 


TxStatusQueueSize 


1 


"TxStatusQueueSize" specifies the size of the queue that delivers status responses 
from the VCU Tx Task to the vcuSend() routine. 
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Constant: 


Value: 


Meaning: 


VCU_ERROR_NO_CODE 


0x1 


Mainly used internally, but also used as a return value for a multicast ! 
"vcuRequestErrnoO" so this routine can be used to check whether any 
errors exist in the system 


VCU_SUCCESS 


0x2 


The VCU command operated successfully 


VCILRECV_EMPTY 


0x3 


The non-blocking vcuRecv() command found no message. 


VCU_BAD_C HAN N E L 


0x4 


An unexpected channel was received. This can be directly, from an API 
call, or indirectly, from data corrupted when copied across the VME bus. 


VCU_MSGQ_FULL 


0x5 


Used internallv on a vcuSendO when the channel is confiaured for coov to 
self. 


VCU_POOL_FULL 


0x6 


The vcuSendO or vcuRecv() call could not find sufficient memory space in 
the memorv dooI to Derform the send or receive 


VCU_NO_RECV_TASK 


0x7 


The vcuRecvO call is a blockino call but no task is available far a hlorkinn 

■ ■ »v » Wi Xw V ¥ y J wUll l»J W WIvvlMI IM ww If y v W \ 1 IV LQOi\ 1 w CI V CI 1 I0J V 1 v IUI 0 UlvvIX \ 1 f \J 

receive call. To fix: configure the system to have more receive tasks. 


VCU_ERR_ON_RECV 


0x10000 


The error occurred in a section of code responsible for receiving. The 
code is most likelv snerifir to hanrilinn vruRervn 


VCU_ERR_ON_SEND 


0x20000 


The error occurred in code specific to handling vcuSend(). 


VCU_ERR_ON_FREE 


0x30000 


The error occurred in code soecific to handlina vcuFree (\ 

ff 1 1 V 1 VI VVA/V 1 I v v hi wUw vpvvii lv lv 1 1GU lu in IVJ VvUI 1 WW 11. 


VCU_ERR_ONLPING 


0x40000 


The error occurred in code SDeciftc to handlina vruPinoH 


VCU_ERR_ON_TEST_PAT 


0x50000 


The error occurred in code snecifieto handlina vruRpnupsfTe^tPflttprnn 

iii^ wi i ui vva/uh^u ill wvvj ^ opwwillv K\*f liaiiUllliy VOVJI X^t^UCOl 1 CJOll O I ICTt illy. 


VCU_ERR_ON_CONFIG 


0x60000 


The error occurred at initialization 


VCU_ERR_ON_ERRNO 


0x70000 


The error occurred in code soecific to handlina vcuReaup^tFrrnnA TKipqp 

9 iiv vi i vi v ww i i vvi iif WW v|^vvll lv K\J I iai I v 1 1 1 ly V vU 1 \wvl UvOlul 1 1 IUW. II IvOv 

error numbers are not stored, so that stored errors can be differentiated 
from errors that occur at the time of the request 


VCU_ERRJN_SOCKET 


0x01000 


The error occurred in code in VcuSocket.cpp. 


VCU_ERR_IN_RXQUEUE 


0x02000 


The error occurred during an RxQueues method. 


VCU_ERRJN_MAILBOX 


0x03000 


The error occurred in mailbox management, in the file VcuMailbox.cpp. 


VCU_ERRJNJNTERFACE 


0x04000 


The error occurred in the interface to the vcuSocket, in VcuComm.cpp. 


VCU_ERRJN_RXTASK 


0x05000 


The error occurred in code in VcuComm.cpp in logic specific to Rx Task 
management. 


VCU_ERRJN_TXTASK 


0x06000 


The error occurred in code in VcuComm.cpp in logic specific to Tx Task 
management. 


VCU_ERR_IN_VME_COPY 


0x07000 


The error occurred in code responsible for copying data across the VME 
bus. 


VCU_ERR_IN_RXPOOL 


0x08000 


The error occurred in a RxPools method. 


VCU_ERRJN_TXPOOL 


0x09000 


The error occurred in a TxPools method. 


VCU_ERR_IN_PAIRPOOL 


OxOaOOO 


The error occurred in a MemPairPool method. 


VCU_ERRJN_ACK 


OxObOOO 


The error occurred in code responsible for handling an automatic 
acknowledgement. 
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Constant: 


Value: 


Meaning: 


VCU_ERR_NO_M EMORY 


0x00010 


The error occurred when requested memory is unavailable. 


VCU_ERR_MSGQ_RECV 


0x00020 


The error occurred while trying to receive from a msgQ. 


VCU_ERR_DATA_SYNCH 


0x00030 


The error occurred when VcuSocket tried to free a memory pool slot 
already freed or during RequestDataPush() when the incorrect identifier 
came back. The latter requires rewriting the Push communication 
protocol. 


VCU_ERR_INTERNAL 


0x00040 


The error occurred when the flow reached a section of code it should not 
have reached. 


VCU_ERR_BAD_POOL_SLOT 


0x00050 


The error occurred when the VcuSocket tried to Free() memory that did 
not come from the pool specified. 


VC U_ERR_BAD_MAI LBOX 


0x00060 


The error occurred when the VcuSocket tried to TriggerRemoteBoard() to 
itself or a destination outside the system boundaries. 


VC U_E RR_BAD_MC AST 


0x00070 


The error occurred because the VCU was reconfigured so that the 
destinations are not specified bitwise, or a multicast was attempted on a 
channel configured for updating ("push ... n ) 


VCU_E RR_U N LOCK_FAILE D 


0x00080 


The error occurred during Update() when the system was unable to unlock 
a memory slot it just locked. This should never occur. 


VCU_ERR_MSGQ_FULL 


0x00090 


The error occurred when a send to a msgQ found the msgQ full. 


VCU_ERR_MSGQ_SEND 


OxOOOaO 


The error occurred while trying to send to a msgQ. The error is not a full 
msgQ error. 


VCU_ERR_BAD_CONFIG 


OxOOObO 


The error occurred when the VCU tables were in conflict with the kernel 
configuration. 


VCU_ERR_TRIG_FAILED 


OxOOOcO 


The error should only occur when automatic acknowledgement is enabled. 
The error means that the automatic ack was not received vcuPinnft ran 
be tried to make sure that the board is accessible. The return value is 
VCU SUCCESS for a successful vcuPinaH 


VCU_ERR_MSG_TOO_BIG 


OxOOOdO 


The error occurred when the size of the message was larger than the 
capacity of the channel. 


VCU_ERR_DESTJNVALID 


OxOOOeO 


The error occurred when a vcuPing() or vcuRequestTestPattern() found 
an invalid destination specified. 


VC U_E RR_TAS K_DI E D 


OxOOOfO 


The error occurred when a receive task is found to be inaccessible. 


VCU_ERR_VME_DMA 


0x00100 


The error occurred when a sysVmeDmaCopy() returned an error value. 


VCU_ERR_ISR_USE 


0x00200 


The error occurred when vcuSend() was called from an ISR. 


VCU_MBOX__FULL_QUEUE 


Oxff 


The error occurred when the receiver's mailbox ISR found its outgoin 
msgQ full. The message is lost, but the sender gets an error message. 


VCU_MBOX_QUEUE_ERROR 


Oxfe 


The error occurred when the receiver's mailbox ISR found its outgoing 
msgQ broken (not just full). The message is lost, but the sender gets an 
error message. All further messages are likely to get the same response. 
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Application 



vcuSendQ 

Call vcuSocket.SendToSelf(). 

• Enqueue message in the Rx 
pool 

• Return status 
Return status 



Figure 34: The sending sequence for the "Queue to self configuration. 



Application 

vcuRecv() 

Call vcuSocket.RecvO 

• Receive from the vcuSocket queue, based on the 
channel. 

• Copy the data into the location specified in the 
calling argument. 

• Write the message size into the calling 
argument. 

• Return status 
Return status 



Figure 35: The receiving sequence for the "Queue to self configuration 
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